Update system firmware

The IX20 operating system firmware images consist of a single file with the following naming convention:

platform-version.bin

For example, IX20-23.12.1.56.bin.

Manage firmware updates using Digi Remote Manager

If you have a network of many devices, you can use Digi Remote Manager Profiles to manage firmware updates. Profiles ensure all your devices are running the correct firmware version and that all newly installed devices are updated to that same version. For more information, see the Profiles section of the Digi Remote Manager User Guide.

Certificate management for firmware images

The system firmware files are signed to ensure that only Digi-approved firmware load onto the device. The IX20 device validates the system firmware image as part of the update process and only successfully updates if the system firmware image can be authenticated.

Downgrading

Downgrading to an earlier release of the firmware may result in the device configuration being erased.

Downgrading from firmware version 22.2.9.x

Beginning with firmware version 22.2.9.x, the IX20 device uses certificate-based communication for enhanced security when connecting to Digi Remote Manager. If you downgrade your firmware from version 22.2.9.x to version 21.11.x or previous, your device will no longer be able to communicate with Remote Manager.

To remedy this issue, select the device in Remote Manager and select Actions > Reset Device Certificate.



  Web

    Log into the IX20 WebUI as a user with full Admin access rights.

  1. On the main menu, click System. Under Administration, click Firmware Update.

  2. Click Download from server.

  3. For Version:, select the appropriate version of the device firmware.
  4. Click Update Firmware.
  1. Select the device in Remote Manager and click Actions > Open Console, or log into the IX20 local command line as a user with full Admin access rights.

    Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.

  2. >Use the system firmware ota check command to determine if new modem firmware is available on the Digi firmware repository.
    > system firmware ota check
Current firmware version is 23.9.74.0
Checking for latest IX20 firmware...
Newest firmware version available to download is '23.12.1.56'
Device firmware update from '23.9.74.0' to '23.12.1.56' is needed
>
  3. Use the modem firmware ota list command to list available firmware on the Digi firmware repository. 
    > system firmware ota list
23.9.74.0
23.12.1.56
>
  4. Perform an OTA firmware update:
    • To perform an OTA firmware update by using the most recent available firmware from the Digi firmware repository:
      1. Update the firmware: 
        > system firmware ota update
Downloading firmware version '23.12.1.56'...
Downloaded firmware /tmp/cli_firmware.bin remaining
Applying firmware version '23.12.1.56'...
41388K
netflash: got "/tmp/cli_firmware.bin", length=42381373
netflash: authentication successful
netflash: vendor and product names are verified.
netflash: programming FLASH device /dev/flash/image1
41408K 100%
Firmware update completed, reboot device
>
      2. Reboot the device:
        > reboot
>

    • To perform an OTA firmware update by using a specific version from the Digi firmware repository, use the version parameter to identify the appropriate firmware version as determined by using system firmware ota list command. For example:

      1. Update the firmware: 
        > system firmware ota update version 23.12.1.56
Downloading firmware version '23.12.1.56'...
Downloaded firmware /tmp/cli_firmware.bin remaining
Applying firmware version '23.12.1.56'...
41388K
netflash: got "/tmp/cli_firmware.bin", length=42381373
netflash: authentication successful
netflash: vendor and product names are verified.
netflash: programming FLASH device /dev/flash/image1
41408K 100%
Firmware update completed, reboot device
>
      2. Reboot the device:
        > reboot
>

  Web

  1. Download the IX20 operating system firmware from the Digi Support FTP site to your local machine.

    2. Log into the IX20 WebUI as a user with full Admin access rights.

  2. On the main menu, click System. Under Administration, click Firmware Update.

  3. Click Choose file.
  4. Browse to the location of the firmware on your local file system and select the file.
  5. Click Update Firmware.

  1. Download the IX20 operating system firmware from the Digi Support FTP site to your local machine.
  2. Select the device in Remote Manager and click Actions > Open Console, or log into the IX20 local command line as a user with full Admin access rights.

    Depending on your device configuration, you may be presented with an Access selection menu. Type admin to access the Admin CLI.

  3. Load the firmware image onto the device. We recommend using the /tmp directory.
    4. > scp host hostname-or-ip user username remote remote-path local local-path to local

    where:

    • hostname-or-ip is the hostname or IP address of the remote host.
    • username is the name of the user on the remote host.
    • remote-path is the path and filename of the file on the remote host that will be copied to the IX20 device.
    • local-path is the location on the IX20 device where the copied file will be placed.

    For example: 

    > scp host 192.168.4.1 user admin remote /home/admin/bin/IX20-23.12.1.56.bin local /tmp/ to local
admin@192.168.4.1's password: adminpwd 
IX20-23.12.1.56.bin			100%	36MB	11.1MB/s	00:03
>
  4. Verify that the firmware file has been successfully uploaded to the device:
    > ls /tmp
-rw-r--r--    1 root     root      37511229 May 16 20:10 IX20-23.12.1.56.bin
-rw-r--r--    1 root     root          2580 May 16 16:44 blank.json
...
>
  5. Update the firmware by entering the system firmware update command, specifying the path and file name to the firmware file:
    > system firmware update file /tmp/IX20-23.12.1.56.bin
36632K
netflash: got "/tmp/IX20-23.12.1.56.bin", length=37511229
netflash: authentication successful
netflash: programming FLASH device /dev/flash/image
36633K 100%
Firmware update completed, reboot device
>
  6. Reboot the device to run the new firmware image using the reboot command. 
    > reboot
Rebooting system
>
  7. Once the device has rebooted, log into the IX20's command line as a user with Admin access and verify the running firmware version by entering the show system command. 
    > show system

 Hostname                 : IX20
 FW Version               : 23.12.1.56
 MAC                      : 0040FF800120
 Model                    : Digi IX20
 Current Time             : Thu, Jan 11, 2024 12:10:00 +0000
 Uptime                   : 42 seconds (42s)

>